home *** CD-ROM | disk | FTP | other *** search
/ The Pier Shareware 1 / Pier Shareware 1.iso / 007a / dm_list.exe / PROG / MISC / DMLIST.DOC next >
Text File  |  1988-01-19  |  50KB  |  2,377 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                                   DMLIST
  17.  
  18.             Source Program Listing And Cross Reference Utility
  19.  
  20.  
  21.                                 Version 1.5
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.   Copyright (C) 1987 by D. M. Software And Systems.  ALL RIGHTS RESERVED.
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.                              Table Of Contents
  70.  
  71.  
  72.  
  73. Section 1 - Introduction
  74.   Table Of Contents................................................... 2
  75.   Copyright And User Support.......................................... 3
  76.   D. M. Software And Systems.......................................... 4
  77.   DMLIST Overview..................................................... 5
  78.   Using DMLIST........................................................ 6
  79.  
  80. Section 2 - Command Line Switches
  81.   -B (Tab Width Setting).............................................. 8
  82.   -D (Date/Time Exclusion)............................................ 9
  83.   -F (Form Feed Appending)............................................10
  84.   -L (Paper Length)...................................................11
  85.   -N (Suppress Line Numbering)........................................12
  86.   -O (Disk Output Selection)..........................................13
  87.   -S (Sort File Names)................................................14
  88.   -T (File Type Specification)........................................15
  89.   -W (Page Width).....................................................16
  90.   -X (Cross Reference)................................................17
  91.   File Name Specification.............................................18
  92.   @ (Response File Specification).....................................19
  93.  
  94. Section 3 - Text Command Strings
  95.   Overview............................................................20
  96.   Page Feed Command...................................................21
  97.   Subtitle Command....................................................22
  98.  
  99. Section 4 - Language Summary And Quick Reference
  100.   Overview............................................................23
  101.   Assembler Quick Reference...........................................24
  102.   BASIC Quick Reference...............................................25
  103.   C Quick Reference...................................................26
  104.   COBOL Quick Reference...............................................27
  105.   dBase Quick Reference...............................................28
  106.   Pascal Quick Reference..............................................29
  107.  
  108. Section 5 - Miscellaneous Information
  109.   Bug Report Form.....................................................30
  110.   Licensing Agreement.................................................31
  111.   Registration Form...................................................32
  112.   Future Update Information...........................................33
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.        January 1988                  DMLIST                  PAGE 2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.                         COPYRIGHT AND USER SUPPORT
  136.  
  137.  
  138. DMLIST is the property of D. M. Software And Systems.  You are granted a
  139. license to distribute this program freely provided you do not modify the
  140. program and no fee is charged for the redistribution or copying.
  141.  
  142. DMLIST is a user supported program.  This means that you can make copies
  143. and distribute it freely provided no fees are charged.  If you find this
  144. program useful, you are asked to make a donation to provide for future
  145. updates and information.  See the last section of this manual for details.
  146.  
  147. You may not use this program in a government or corporate environment
  148. without a site license agreement, except for the sole purpose of
  149. evaluation.  See the last section of this manual for details on site
  150. licensing.
  151.  
  152. Licensing will provide you with information about this program and others
  153. that may be released by D. M. Software And Systems.
  154.  
  155. All suggestions are welcome.  After all, user supported software means that
  156. the user decides what goes into the next release.  The only thing I do not
  157. want to hear about are suggestions for some obscure or little used language
  158. such as MPS or SNOBOL.  There are dozens of these languages out there and I
  159. cannot possibly support them all.  Some languages, such as FORTH, have a
  160. reasonable following, and are not currently supported, but will be
  161. considered if I hear enough about it.  Do not expect an immediate upgrade,
  162. however.  Someone has to use and understand the language before a
  163. reasonable amount of support can be given.
  164.  
  165. This program, and others like it (sometimes referred to as Shareware or
  166. Freeware) are for everyone's benefit.  This is an attempt to provide
  167. quality software at reasonable cost.  The overhead involved in starting a
  168. software company and distribution network are ungodly high.  So please, if
  169. you find this program useful make a donation for its upkeep.  And support
  170. other programs like it such as ARC, PC-TALK and QMODEM.
  171.  
  172. After all, did you ever get any chance to test a package from one of the
  173. big name software companies before using it ?
  174.  
  175. By the way, just so we are legal......
  176.  
  177. Turbo Pascal and Turbo C are trademarks of Borland International.
  178. dBase, dBase III and dBase III Plus are trademarks of Ashton-Tate.
  179. IBM and TopView are the trademarks of International Business Machines.
  180. MS-DOS, MS-ASM and Windows are all trademarks of Microsoft.
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.        Section 1                                        Introduction
  195.        January 1988                  DMLIST                  PAGE 3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.                         D. M. Software And Systems
  202.  
  203.  
  204. D. M. Software And Systems is a one man consulting and contracting firm.  I
  205. have fifteen years of experience in programming and analysis.  I have
  206. finally settled into the microcomputer and networking areas of DP and I am
  207. very happy there.  However, I am always upset over some of the simple tools
  208. that are missing from our trade.  This program is an attempt to rectify
  209. that situation.
  210.  
  211. I have no intention of becoming another Microsoft.  I have decided to
  212. distribute this program though the Shareware channels because I find it
  213. useful and others I have shown it to do too.
  214.  
  215. Since I am a one man shop,  please understand that telephone support is out
  216. of the question.  At least right now.  Things could always change in the
  217. future.  Just remember I am not in this to get rich.  I am just trying to
  218. help out my fellow programmers.  Of course, if you want a contractor or
  219. consultant........
  220.  
  221. If all else fails please write to:
  222.  
  223.               D. M. Software And Systems
  224.               6572 Suson Woods Drive
  225.               St. Louis, MO 63128
  226.  
  227. As a last resort only (you need to be panicky!!! If your heart is about to
  228. come out of your chest) you can call me at (314) 296-4719.
  229.  
  230. I tried to make this program simple to use, but there are many options
  231. currently supported.  So some times things get a little out of hand.  I use
  232. this program for assembler, C and dBase, so there is little chance of an
  233. error.  However, I do not use COBOL, Pascal or BASIC on an everyday basis,
  234. so there is some chance for an error with these languages.
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.        Section 1                                        Introduction
  261.        January 1988                  DMLIST                  PAGE 4
  262.  
  263.  
  264.  
  265.  
  266.  
  267.                               DMLIST Overview
  268.  
  269.  
  270. This program is designed to help the serious programmer print formatted
  271. program listings and provide them with a certain amount of help, such as a
  272. cross reference listing.
  273.  
  274. To that end it contains certain features that I, as a programmer, always
  275. want but can never find in a commercially available utility; such as the
  276. ability to sort the input file names.  Have you ever looked through a 500
  277. page listing of 40 source modules printed in no particular order ?  Come on
  278. out there.  What are those guys thinking about ?
  279.  
  280. Built in support is provided for the most popular languages on the PC.
  281. These include the following:
  282.  
  283.               ASM - 80x86 assembler
  284.               BASIC
  285.               C
  286.               COBOL
  287.               dBase
  288.               PASCAL
  289.  
  290. Other languages may well be supported in the future, as long as they are
  291. not totally obscure.  Certain modern day languages have been omitted from
  292. here simply because I (the author) are almost completely unfamiliar with
  293. them.  These include Ada, LISP, Modula-2 and FORTH.  You can except DMLIST
  294. to support these in a future release.  Please don't ask me when!  I do have
  295. every intention of supporting them.
  296.  
  297. Also, since DMLIST was written in C, and I have already ordered a C++
  298. compiler (preprocessor actually) I will provide any additional support for
  299. it that is deemed necessary, although it does seem to need any.
  300.  
  301. Anyway, enough of that.  On to using DMLIST.
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.        Section 1                                        Introduction
  327.        January 1988                  DMLIST                  PAGE 5
  328.  
  329.  
  330.  
  331.  
  332.  
  333.                                Using DMLIST
  334.  
  335.  
  336. DMLIST is a normal executable DOS program.  It has built in support for
  337. several languages.  Please refer to the appropriate Quick Reference for
  338. specific language support.
  339.  
  340. DMLIST calling syntax is:
  341.     DMLIST filenames [FLAGS] [filenames] [flags]
  342.  
  343. Notice that more than one file name can be specified on a command line and
  344. may include the normal DOS wildcard characters.  All of the flags used in
  345. DMLIST must be preceded with a - (hyphen) or a / (slash).  Either character
  346. can be used for a flag and they can be mixed on a command line.  Personally
  347. I always use a hyphen and that is what will be throughout this document.
  348. These is no specific sequence for file names or flags.  The entire command
  349. line is parsed before printing starts so all formatting options are known
  350. in advance.
  351.  
  352. Allowable flags and their meanings are:
  353.  
  354.     -B   Used to specify a tab length.
  355.     -D   To specify a date and/or time for file printing.
  356.     -L   Use this to change the length of the printed page.
  357.     -N   To suppress line numbering.
  358.     -O   To specify disk output.
  359.     -S   You can use this to sort all file names before printing.
  360.     -T   To specify a file's type if it has an unsupported
  361.          extension.
  362.     -V   Enables Verbose execution.  Default is OFF
  363.     -W   Is used to change the width of the printed page.
  364.     -X   Is used to print a cross reference listing.
  365.  
  366. Built in support is provided for the most popular languages on the PC.
  367. These normally have certain extensions for their source files and that is
  368. how their type can normally determined.  A file's default type can be
  369. overridden with the -T flag.  See that section for more details.  Here is a
  370. list of normal file extensions and the types supported, along the value to
  371. change a file's type:
  372.  
  373. Language                Normal Extension(s)      Override value
  374. ---------------------   -------------------      --------------
  375. ASM - 80x86 assembler    .ASM and .MAC                A
  376. BASIC                    .BAS                         B
  377. C                        .C and .H                    C
  378. COBOL                    .COB                         O
  379. dBase                    .PRG                         D
  380. PASCAL                   .PAS, .BOX and .INC          P
  381.  
  382. A sample file in Assembler, two C files (a .c and .h), a Pascal, and a
  383. dBase file have been provided.  You may wish to print them before reading
  384. this manual so you can see some examples.  Use the command 
  385.  
  386.     DMLIST SAMPLE.* -S -B5 -X
  387.  
  388. if you are using 14 7/8" by 11" paper.
  389.  
  390.  
  391.  
  392.        Section 1                                        Introduction
  393.        January 1988                  DMLIST                  PAGE 6
  394.  
  395.  
  396.  
  397.  
  398.  
  399.                                Using DMLIST
  400.  
  401.  
  402. Also, a PIF file is included in the archive for users wishing to run this
  403. program under Windows DOS or TopView.  Simply copy it to your PIF
  404. directory.  After selecting DMLIST you will be prompted for the normal
  405. command line parameters.  Note that TopView and Windows use identical PIF
  406. files.
  407.  
  408. Please note here the difference between a zero (0) and the letter "oh" (O).
  409.  
  410. A more detailed explanation of the command line options and the text
  411. commands follows.
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.        Section 2                             Command Line Parameters
  459.        January 1988                  DMLIST                  PAGE 7
  460.  
  461.  
  462.  
  463.  
  464.  
  465.                         -B flag (tab width setting)
  466.  
  467.  
  468. This is a command line switch for changing the default tab width.  DOS
  469. normally supports 8 space tab lengths, and so does this program.  It can be
  470. changed to any value by specifying the length in the -B switch.  For
  471. example:
  472.  
  473.  DMLIST SAMPLE.C -B5
  474.  
  475. will change the tab width to 5 spaces.  This does not mean that 5 spaces
  476. will be inserted, just enough to pad to the next space who's position is
  477. divisible by 5.
  478.  
  479. There is a range limit of between one and twenty spaces for a tab width.
  480. But some printers allow the setting of its tabs.  If your printer is one
  481. and you have them set to your liken DMLIST can suppress tab expansion by
  482. using the flag -b0.
  483.  
  484.  
  485. EXCEPTION - COBOL normally defines tab spacing as every four spaces.  Since
  486. most PC COBOL compilers have also done away with the line numbering scheme,
  487. tabs are set for four spaces for a COBOL file unless the eight character
  488. spacing has already been overridden.
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.        Section 2                             Command Line Parameters
  525.        January 1988                  DMLIST                  PAGE 8
  526.  
  527.  
  528.  
  529.  
  530.  
  531.                     -D flag (Date/Time Exclusion flag)
  532.  
  533.  
  534. This is the one option that prompted me to write this program.  After
  535. several years of trying to write systems that have 20, 40 or more source
  536. modules, I got tired of having to reprint entire listings just to get
  537. updates to three or four modules.  The flag work like this:
  538.  
  539.     DMLIST *.PAS -D10/11/85@12:00
  540.  
  541. Looks pretty bad doesn't it ?  Actually it is a handy feature.  What the
  542. -D10/11/85@12:00 says is print all .PAS files last modified after noon on
  543. October 11th, 1985.
  544.  
  545. The date and the time are both optional.  If no date is specified then the
  546. current system date is used.  If a date is specified and no time then all
  547. files with a date LATER than this one are printed.  For example:
  548.  
  549.     DMLIST *.PAS -D10/11/85
  550.  
  551.     will print all .PAS files modified on or after October 11th, 1985 and
  552.  
  553.     DMLIST *.PAS -D@13:00
  554.  
  555.     will print all .PAS files modified after 1:00pm today.
  556.  
  557. The time specified is military time.  (Just add 12 to the hours if it is
  558. after 12:00 noon).  The minutes may be omitted so that both of the
  559. following will produce the same results:
  560.  
  561.     DMLIST *.C -@13:00
  562.     DMLIST *.C -@13
  563.  
  564. The date must be in the format MM/DD/YY except that a - may be used to
  565. separate the values so 10/11/85 and 10-11-85 are equivalent.
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.        Section 2                             Command Line Parameters
  591.        January 1988                  DMLIST                  PAGE 9
  592.  
  593.  
  594.  
  595.  
  596.  
  597.                         -F flag (Append form feeds)
  598.  
  599.  
  600. Some printers have the annoying habit of not printing the last line sent to
  601. it, even if a carriage return and line feed.  The original intention of
  602. this flag was to append a form feed to the end of the last file printed.
  603. However, this flag can also be used to simply eject two pages (or more) so
  604. the paper can be removed.
  605.  
  606. If this flag is not included, then NO form feeds are appended.  If -f alone
  607. is included then one form feed is included.  You can specify the number of
  608. form feeds by placing a decimal number behind the -f.  For example:
  609.  
  610.     DMLIST SAMPLE.C -b5 -F5
  611.  
  612. will add five form feeds to the end of the run.
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.        Section 2                             Command Line Parameters
  657.        January 1988                  DMLIST                  PAGE 10
  658.  
  659.  
  660.  
  661.  
  662.  
  663.                        -L flag (Change page length)
  664.  
  665.  
  666. You can use this to change the default page length by specifying a decimal
  667. number after the -L.  For example:
  668.  
  669.     DMLIST *.C -L50
  670.  
  671. will change the page length to 50 lines.  The built in default is 55 lines.
  672. This is normal for 6 line per inch on paper that is 11 inches long.  It
  673. will leave a bottom margin of 2 lines.
  674.  
  675. Remember that this is only text lines.  It does NOT include the two line
  676. (or more) header at the top of the page.  So if you wanted to print only 25
  677. lines per page so there was a blank space after it can be done.
  678.  
  679. The length of the page must be between 25 and 100 lines.  Any other value
  680. is assumed to be an erroneous entry.
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.        Section 2                             Command Line Parameters
  723.        January 1988                  DMLIST                  PAGE 11
  724.  
  725.  
  726.  
  727.  
  728.  
  729.                       -N flag (Suppress line numbers)
  730.  
  731.  
  732. You can use this option to suppress the printing of line numbers. If you
  733. invoke this option it does change formatting slightly.  Normally there is a
  734. 7 character lead in with line numbers (a five digit line number, a colon
  735. and a space).  It will now be changed to two characters.  This is so line
  736. continuation markers can be printed.  Normally when a line is split during
  737. formatting the second, and all subsequent lines, have the line number
  738. omitted and a hyphen directly beneath the colon in the first part of the
  739. line.  Suppressing numbering causes a two space indentation for the first
  740. past of a line and a hyphen and a space for all parts there after. For
  741. example:
  742.  
  743. 1) 100: This is a sample...........more text
  744.       - line for showing formatting options...
  745.  
  746. 2)   This is a sample............more text
  747.    - line for showing formatting options...
  748.  
  749. are both the same text with line numbering on in example 1 and suppressed
  750. in example 2.
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.        Section 2                             Command Line Parameters
  789.        January 1988                  DMLIST                  PAGE 12
  790.  
  791.  
  792.  
  793.  
  794.  
  795.                       -O Flag (Disk output selection)
  796.  
  797.  
  798. This tells DMLIST to place the printed output in a disk file instead of
  799. directing it to the printer.  The output file will have the same name as
  800. the source file with an extension of .PRN.  For example:
  801.  
  802.     DMLIST SAMPLE.C -O
  803.  
  804. will produce the disk file SAMPLE.PRN
  805.  
  806. You must be a little careful when using this option and the * or ?
  807. characters in a file's extension.  If you type the line:
  808.  
  809.     DMLIST SAMPLE.* -O
  810.  
  811. there will be a SAMPLE.PRN file created, but it will only contain the
  812. formatted output from the last file.  See the file name specification
  813. section for a more detailed explanation.
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.        Section 2                             Command Line Parameters
  855.        January 1988                  DMLIST                  PAGE 13
  856.  
  857.  
  858.  
  859.  
  860.  
  861.                  -S Flag (Sort file names before printing)
  862.  
  863.  
  864. This is another convenient feature.  Normally all files on the command line
  865. are printed in order FROM RIGHT TO LEFT.  This option will let you specify
  866. the names in any order and include wild card characters in any order and
  867. have the source modules print in alphabetical order.  For example,  assume
  868. you have a directory containing the files x1.c, x2.c, x3.c x4.c and xx.h.
  869. You can look at a directory listing to find out what order this would be
  870. found in, but you can get them printed in the order shown above with the
  871. following command:
  872.  
  873.     DMLIST X?.* -S
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.        Section 2                             Command Line Parameters
  921.        January 1988                  DMLIST                  PAGE 14
  922.  
  923.  
  924.  
  925.  
  926.  
  927.                      -T flag (specify input file type)
  928.  
  929.  
  930. This flag is used to specify the file type for files with an extension that
  931. is not included in the table below.  Note that when this flag is included
  932. that ALL files on this run will be assumed to be the specified type.  So if
  933. your directory contains the files SAMPLE.PAS and SAMPLE.BAS then the line
  934.  
  935.     DMLIST SAMPLE.PAS SAMPLE.BAS -TB
  936.  
  937. will cause both files to be checked as if they are BASIC files.  Normally a
  938. file's type is determined by checking the extension.  No page feed or
  939. subtitle command is supported for undetermined file types.
  940.  
  941. Use the table below to determine if your files conform to this standard. If
  942. you have a popular compiler that uses extensions that are not shown below,
  943. please write and it will be taken care of.  See the bug report section for
  944. more details.
  945.  
  946.  
  947.  
  948. Language                Normal Extension(s)      Override value
  949. ---------------------   -------------------      --------------
  950. ASM - 80x86 assembler    .ASM and .MAC                A
  951. BASIC                    .BAS                         B
  952. C                        .C and .H                    C
  953. COBOL                    .COB                         O
  954. dBase                    .PRG                         D
  955. PASCAL                   .PAS, .BOX and .INC          P
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.        Section 2                             Command Line Parameters
  987.        January 1988                  DMLIST                  PAGE 15
  988.  
  989.  
  990.  
  991.  
  992.  
  993.                          -W flag (Set line width)
  994.  
  995.  
  996. You can use this flag to change the default line width.  The default is 132
  997. characters.  This width includes the characters at the beginning of a line.
  998. If there are line numbers included then this is 7 characters and if line
  999. numbers are suppressed it is 2.  Most programmers using paper that 14 7/8
  1000. inches wide.  For 8 1/2 inch wide paper you can normally get 85 characters
  1001. on a line.  This varies as some printers print characters at a different
  1002. rate per inch.
  1003.  
  1004. A verification message will be printed on start up.
  1005.  
  1006. Only values between 75 and 256 are allowed.  Any other value is assumed to
  1007. be an erroneous entry.
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.        Section 2                             Command Line Parameters
  1053.        January 1988                  DMLIST                  PAGE 16
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.                      -X flag (Cross Reference Listing)
  1060.  
  1061.  
  1062. This flag will cause DMLIST to print a function/procedure and variable
  1063. cross reference listing at the end of the program listing.  Currently BASIC
  1064. has not standard way to specify a procedure or function name that I am
  1065. aware of.  There is no function/procedure cross reference available for
  1066. BASIC programs.
  1067.  
  1068. Currently the name column in the listing will only contain the first 14
  1069. characters of a name, followed by the line numbers that reference it.
  1070.  
  1071. String (or character) literals are supported.  Numeric literals are not.
  1072. All string literals will contain the beginning ' or " and the ending one if
  1073. it does not increase the length of the string past 14 characters.  Leading
  1074. and trailing spaces are included.
  1075.  
  1076. Entries will be listed in the following order;
  1077.  
  1078.               1) All literals starting with a '
  1079.               2) All literals starting with a "
  1080.               3) All variables and function/procedures.
  1081.  
  1082. They are NOT sorted in strict ASCII order, but alphabetical .  All items
  1083. are compared without case sensitivity.  For an example see the output from
  1084. SAMPLE.PAS.
  1085.  
  1086.  
  1087. EXCEPTION - dBase allows both ' and " to be used as a string delimiter.
  1088. Other languages allow both of these, but they have two different meanings.
  1089. So for dBase files, ' and " are treated as equals for sorting purposes.
  1090. However, the actual source text for the first occurrence of a string will be
  1091. printed in the cross reference.
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.        Section 2                             Command Line Parameters
  1119.        January 1988                  DMLIST                  PAGE 17
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.                           File Name Specification
  1126.  
  1127.  
  1128. Source file names can contain the normal DOS wildcard characters * and ?.
  1129. However, a certain amount of warning is required here.  If the -O (disk
  1130. output) flag is specified, and there is a wildcard in the extension,
  1131. separate .PRN files are not created.  They are simply overwritten each time
  1132. a file with the same name is encountered.  For example, if you specified
  1133.  
  1134.     DMLIST X?.*
  1135.  
  1136. and your directory contained the files x1.c, x2.c, x3.c and xx.h and they
  1137. were printed in that order, there would be separate .PRN's for each.  But
  1138. if your directory contained x1.c, x2.c, x1.h and x2.h there would only be a
  1139. x1.PRN and x2.PRN and they would contain ONLY THE LAST ONE PRINTED.
  1140.  
  1141. When there is a wildcard in a file's extension, it is possible for DMLIST
  1142. to encounter a .OBJ or .EXE file.  Since I suspect no one wants to try and
  1143. print these, I automatically ignore all files with the extensions .OBJ,
  1144. .PRN, .EXE, .COM, .BAK and .BIN.  Note that .BAT files would be printed
  1145. since they are normal ASCII text files.  .PRN files are excluded since
  1146. there were generated by this program anyway.  .BAK files are excluded since
  1147. some editors automatically create them are they are seldom needed.
  1148.  
  1149. It is suggested that whenever a wildcard is specified that the -S (sort)
  1150. option is also used.
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.        Section 2                             Command Line Parameters
  1185.        January 1988                  DMLIST                  PAGE 18
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.                    @ flag (Response file specification)
  1192.  
  1193.  
  1194. After all of the above discussion it should be obvious that this is a very
  1195. useful documentation tool.  However, not everyone has a standard way of
  1196. doing things, and that includes odd paper sizes.  Fortunately, there is a
  1197. way to specify these type of things once and reusing them.
  1198.  
  1199. Typing @ followed by a file name will cause DMLIST to read this file for
  1200. run time parameters.  For example if you want to print 60 lines per page
  1201. and 80 characters on a line you can create the file DMLIST.RSP with the
  1202. following lines:
  1203.     -L60
  1204.     -W80
  1205. and use these parameters always by typing:
  1206.  
  1207.     DMLIST @DMLIST.RSP filenames
  1208.  
  1209. All command lines flags except another @ can be contained in this file and
  1210. can be in any order.  Also it is not required to specify parameters on
  1211. separate lines.  So the line
  1212.  
  1213.     -L60 -W80
  1214.  
  1215. is the same as the above example.
  1216.  
  1217. There is no specific extension required for this file.
  1218.  
  1219. If you have several of these files they do not have to be located in the
  1220. default directory.  You can keep them in the same directory with DMLIST.EXE
  1221. and the program will find them.
  1222.  
  1223. The response file's name can appear anywhere on the command line after the
  1224. program name.  However, only one response file can be specified.  You are
  1225. also not allowed to nest response file names.
  1226.  
  1227. Any parameters that are specified in the file override any found on the
  1228. command line.
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.        Section 3                                Text Command Strings
  1251.        January 1988                  DMLIST                  PAGE 19
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.                            Text Command Strings
  1258.  
  1259.  
  1260. There are currently only two commands that fall into this category; PAGE
  1261. and <S> (for subtitles).  They should be relatively self-explanatory.
  1262.  
  1263. EXCEPTION - Since the assembler used by most of use already has the page
  1264. feed and subtitle directives available, they were duplicated in this
  1265. program.  You must PAGE and SUBTTL directives where you wish.
  1266.  
  1267. The correct procedure for including one of these commands is to make the
  1268. directive a comment, according to the rules of that language.  Some
  1269. languages use more than one comment delimiter, and for those I have
  1270. selected a format.
  1271.  
  1272. Any amount of white space may be between the beginning and end of the
  1273. directive and the beginning and end of a line.  For example -
  1274.  
  1275.     /* PAGE */ and
  1276.               /*        PAGE      */
  1277.  
  1278. are both acceptable in C.  Also the name of the directive is not case
  1279. sensitive, so the word PAGE may be typed as Page, PAGE or page if you wish.
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.        Section 3                                Text Command Strings
  1317.        January 1988                  DMLIST                  PAGE 20
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.                   Page Feed Command - Text Command String
  1324.  
  1325.  
  1326. This command is used to perform a forced page feed.  Simply make the word
  1327. PAGE a command and DMLIST will start a new page with the next line.  The
  1328. table below shows the correct format for each of the supported languages.
  1329.  
  1330. Language                          Format
  1331. --------                          ------
  1332. Assembler                         PAGE
  1333. BASIC                             'PAGE (DO NOT USE REM PAGE)
  1334. C                                 /*PAGE*/
  1335. COBOL                             (not supported)
  1336. dBase                             *PAGE
  1337. Pascal                            {PAGE} (DO NOT USE (*PAGE*) )
  1338.  
  1339. See the sample files provided for examples.
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.        Section 3                                Text Command Strings
  1383.        January 1988                  DMLIST                  PAGE 21
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.                   Subtitle Command - Text Command String
  1390.  
  1391.  
  1392. You can use this command to print a subtitle. Only one subtitle is active
  1393. at a time.  Every subtitle command encountered replaces the previous one.
  1394. Normally a subtitle command would immediately precede a page command.  See
  1395. the sample files for an example. For purposes of discussion, assume there
  1396. are 132 characters on a line.
  1397.  
  1398. Normally there are two header lines on a page.  The first contains the time
  1399. and date of the listing, the source file's name and the page number.  The
  1400. only item on the second line is the time and date the file was last
  1401. changed.
  1402.  
  1403. Adding a subtitle will center the text string specified on the second line.
  1404. For a clear example print the test file named sample1.c
  1405.  
  1406. This command is a little different than the page feed command. The correct
  1407. format is for a <s> (with the <>) and the subtitle string to be placed in a
  1408. comment.  For example - 
  1409.  
  1410.     /*<S>Subtitle Sample Line*/
  1411.  
  1412. for C.  See the table below for the correct format for your particular
  1413. language.
  1414.  
  1415. Language                Subtitle Format
  1416. --------                ---------------
  1417. Assembler               SUBTTL (See the assembler manual)
  1418. BASIC                   '<S>text
  1419. C                       /*<s>text*/
  1420. COBOL                   (not supported)
  1421. dBase                   *<S>text
  1422. PASCAL                  {<S>text}
  1423.  
  1424. See the sample files provided for examples.
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.        Section 4                                    Language Summary
  1449.        January 1988                  DMLIST                  PAGE 22
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.                          Language Quick Reference
  1456.  
  1457.  
  1458. The tables below are provided as a quick reference only.  There is extra
  1459. space at the bottom of each page for your notes.  Please use this space as
  1460. you see fit.
  1461.  
  1462. Please note that BASIC, dBase and Pascal all have more than one way to
  1463. delimit comments.  This means that there would also be more than one way to
  1464. delimit a page feed or subtitle command.  However, only one way is
  1465. currently supported for both languages.  Please refer to the tables that
  1466. follow.
  1467.  
  1468. Remember, imbedded text commands are NOT case sensitive.
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.        Section 4                                    Language Summary
  1515.        January 1988                  DMLIST                  PAGE 23
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.                      Assembly Language Quick Reference
  1522.  
  1523.  
  1524.  
  1525. Default Tab Spacing               8 Spaces
  1526.  
  1527. File Extensions Supported         .ASM and .MAC
  1528.  
  1529. Page Feed Command Format          PAGE (See assembler manual)
  1530.  
  1531. Subtitle Command Format           SUBTTL (See assembler manual)
  1532.  
  1533. Type Override On Command Line     -TA
  1534.  
  1535.  
  1536. NOTES
  1537.  
  1538. 1) All of the 80186, 80286, 8087 and 80287 op codes and the normal
  1539. Microsoft MASM directives are considered reserved words and will not be
  1540. listed in a cross reference, EVEN IF THERE ARE OP CODES FOR THE EXTRA
  1541. PROCESSORS AND NOT A DIRECTIVE IN THE SOURCE FILE !.
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.        Section 4                                    Language Summary
  1581.        January 1988                  DMLIST                  PAGE 24
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.                       BASIC Language Quick Reference
  1588.  
  1589.  
  1590.  
  1591. Default Tab Spacing               8 spaces
  1592.  
  1593. File Extension Supported          .BAS
  1594.  
  1595. Page Feed Command Format          'PAGE
  1596.  
  1597. Subtitle Command Format           '<S>subtitle text
  1598.  
  1599. Type Override On Command Line     -TB
  1600.  
  1601.  
  1602. NOTES
  1603.  
  1604. 1) Do not use the REM do start the page feed and subtitle commands.
  1605.    This is not currently supported.
  1606.  
  1607. 2) There is no support for PROCEDURE/FUNCTION cross reference for the BASIC
  1608.    dialects that do not support named procedures.
  1609.  
  1610. 3) Files must be saved with the ,A option.  Consult your BASIC manual.
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.        Section 4                                    Language Summary
  1647.        January 1988                  DMLIST                  PAGE 25
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.                        'C' Language Quick Reference
  1654.  
  1655.  
  1656.  
  1657. Default Tab Spacing               8 spaces
  1658.  
  1659. File Extensions Supported         .C and .H
  1660.  
  1661. Page Feed Command                 /* PAGE */
  1662.  
  1663. Subtitle Command Format           /* <S> subtitle text */
  1664.  
  1665. Type Override On Command Line     -TC
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.        Section 4                                    Language Summary
  1713.        January 1988                  DMLIST                  PAGE 26
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.                       COBOL Language Quick Reference
  1720.  
  1721.  
  1722.  
  1723. Default Tab Spacing               4 spaces
  1724.  
  1725. File Extension Supported          .COB
  1726.  
  1727. Page Feed Command Format          not supported
  1728.  
  1729. Subtitle Command Format           not supported
  1730.  
  1731. Type Override On Command Line     -TO
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.  
  1740.  
  1741.  
  1742.  
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.        Section 4                                    Language Summary
  1779.        January 1988                  DMLIST                  PAGE 27
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.                       dBase Language Quick Reference
  1786.  
  1787.  
  1788.  
  1789. Default Tab Spacing               8 spaces
  1790.  
  1791. File Extension Supported          .PRG
  1792.  
  1793. Page Feed Command Format          * PAGE
  1794.  
  1795. Subtitle Command Format           * <s> subtitle text
  1796.  
  1797. Type Override On Command Line     -TD
  1798.  
  1799.  
  1800. NOTES -
  1801.  
  1802. 1) There are two string delimiters in dBase, ' and ".  They are equivalent
  1803. in dBase.  For this reason, DMLIST will sort both of these as equals when
  1804. printing a cross reference.  The listing will contain the delimiter used in
  1805. the source text.
  1806.  
  1807. 2) There are two comment delimiters in dBase, * and &&.  Only * can be used
  1808. with the imbedded text commands.
  1809.  
  1810.  
  1811.  
  1812.  
  1813.  
  1814.  
  1815.  
  1816.  
  1817.  
  1818.  
  1819.  
  1820.  
  1821.  
  1822.  
  1823.  
  1824.  
  1825.  
  1826.  
  1827.  
  1828.  
  1829.  
  1830.  
  1831.  
  1832.  
  1833.  
  1834.  
  1835.  
  1836.  
  1837.  
  1838.  
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.        Section 4                                    Language Summary
  1845.        January 1988                  DMLIST                  PAGE 28
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.                       Pascal Language Quick Reference
  1852.  
  1853.  
  1854.  
  1855. Default Tab Spacing               8 spaces
  1856.  
  1857. File Extension Supported          .PAS, .BOX and .INC
  1858.  
  1859. Page Feed Command Format          {PAGE}
  1860.  
  1861. Subtitle Command Format           {<S> subtitle text}
  1862.  
  1863. Type Override On Command Line     -TP
  1864.  
  1865.  
  1866.  
  1867. NOTES
  1868.  
  1869. 1) Do not use (* *) to delimit the page feed and subtitle commands.
  1870.    This is not currently supported.
  1871.  
  1872. 2) The Turbo Pascal reserved words are also included in DMLIST's internal
  1873. table and do not appear in a cross reference listing.  I seriously doubt
  1874. this will cause anyone a problem, with the possible exception of the word
  1875. STRING.  These additional reserved words are:
  1876.  
  1877.               Absolute
  1878.               External
  1879.               Inline
  1880.               Overlay
  1881.               Shl
  1882.               Shr
  1883.               String
  1884.               Xor
  1885.  
  1886.  
  1887.  
  1888.  
  1889.  
  1890.  
  1891.  
  1892.  
  1893.  
  1894.  
  1895.  
  1896.  
  1897.  
  1898.  
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.        Section 5                    Bug Report & Licensing Agreement
  1911.        January 1988                  DMLIST                  PAGE 29
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.                 Licensing Agreement, Bug Report And Updates
  1918.  
  1919.  
  1920.                    D. M. Software And Systems Bug Report
  1921.  
  1922. Name Of Program _____________________________________________
  1923.  
  1924. Version Number ______________________________________________
  1925.  
  1926. Serial Number _______________________________________________
  1927.  
  1928. User's Name _________________________________________________
  1929.  
  1930. Company _____________________________________________________
  1931.  
  1932. Address _____________________________________________________
  1933.  
  1934.         _____________________________________________________
  1935.  
  1936. City    _____________________________________________________
  1937.  
  1938. State   ______________          Zip Code ____________________
  1939.  
  1940. Day Time Telephone (include area code) ______________________
  1941.  
  1942. Problem Description _________________________________________________
  1943.  
  1944. _____________________________________________________________________
  1945.  
  1946. _____________________________________________________________________
  1947.  
  1948. Instructions:
  1949.  
  1950.     1) Please provide a brief description of the problem BUT IT IS MORE
  1951.        IMPORTANT TO BE SPECIFIC.  Use the back of the page if required.
  1952.  
  1953.     2) Please provide your name, address and day time telephone number
  1954.        in case I have trouble duplicating the error.
  1955.  
  1956.     3) If at all possible, enclose a diskette with a copy of the data
  1957.        file(s) in question.  Any data or code received by D. M. Software
  1958.        And Systems will be considered proprietary and returned as soon as
  1959.        the problem is fixed, along with your diskette.
  1960.  
  1961.     4) Unregistered user will immediately have their data and diskette(s)
  1962.        returned.  NO SUPPORTED WILL BE PROVIDED FOR UNREGISTERED USERS AND
  1963.        THERE ARE ABSOLUTELY NO EXCEPTIONS TO THIS RULE!!!!!!!!!
  1964.  
  1965.     5) The first user to report a bug will receive a free fix.  So will
  1966.        any user who has a problem that could well render his program
  1967.        unusable.
  1968.  
  1969.     6) Complete this form and mail it, along with a sample to:
  1970.  
  1971.                         D. M. Software And Systems
  1972.                         6572 Suson Woods Drive.
  1973.                         St. Louis, MO  63128
  1974.  
  1975.  
  1976.        Section 5                    Bug Report & Licensing Agreement
  1977.        January 1988                  DMLIST                  PAGE 30
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.                 Licensing Agreement, Bug Report And Updates
  1984.  
  1985.  
  1986. Since I have to put food on my table too, I ask that if you find this
  1987. program useful, you make a donation for its upkeep.  After all, I went to a
  1988. lot of trouble to make sure this program is useful!  This will also entitle
  1989. you to information and notice about upgrades to this program and any others
  1990. that D. M. Software And Systems may release in the future.
  1991.  
  1992. Do not use this program in a governmental or commercial environment without
  1993. registering your copy, except for the sole purpose of evaluation.  As of
  1994. December 1987 the following fee schedule is being used:
  1995.  
  1996.     Number Of Copies              Charge Per Copy
  1997.     ----------------              ---------------
  1998.          1 - 4                       $40.00
  1999.          5 - 9                       $37.50
  2000.         10 - 19                      $35.00
  2001.         20 - 49                      $30.00
  2002.         50 or more                   $25.00
  2003.  
  2004. For questions or current pricing, call D. M. Software And Systems at (314)
  2005. 296-4719, or write to:
  2006.  
  2007.               D. M. Software And Systems
  2008.               6572 Suson Woods Dr.
  2009.               St. Louis, MO  63128
  2010.  
  2011. For orders outside the United States please add $5 dollars and enclose an
  2012. international money order.  No other form of payment will be accepted. All
  2013. amounts are in United States dollars.  Please write for foreign currency
  2014. amounts.
  2015.  
  2016. You will be provided with one update to the most current version upon
  2017. receipt of your registration when you do NOT already have the most current
  2018. version.  The prices above are guaranteed through March 1, 1988.  So it may
  2019. be necessary to charge an additional fee.  Both of these items are subject
  2020. to change after March 1, 1988.
  2021.  
  2022. Fees for network installation are based on the number of user that have
  2023. access to it at any one time.  i.e. - The number of terminals attached to
  2024. the network.
  2025.  
  2026. D. M. Software And Systems make no guarantees for DMLIST.  This program is
  2027. not warranted or guaranteed, and will not provide any support other than
  2028. that outlined in the above documentation.
  2029.  
  2030. The user is provided a license for copying and redistribution of DMLIST as
  2031. long as no charge is made for the copying and redistribution.  You may make
  2032. as many copies as you deem necessary for archival purposes and may install
  2033. it on more than one machine, IF IT WILL ONLY BE USED ON ONE MACHINE AT A
  2034. TIME.  (Treat it like a book).
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042. dml1.000188
  2043.        January 1988                  DMLIST                  PAGE 31
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.                          DMLIST REGISTRATION FORM
  2050.  
  2051.  
  2052. Please fill out the form below for registration and mail to:
  2053.  
  2054.     D. M. Software And Systems
  2055.     6572 Suson Woods Drive
  2056.     St. Louis, MO 63128
  2057.  
  2058. For commercial or governmental orders please list only one name for contact.
  2059. See the previous page for pricing information.
  2060.  
  2061. Your phone number will only be used when you have reported a bug and I
  2062. cannot duplicate the problem.
  2063.  
  2064. Writing your name below says you have read the attached Licensing Agreement
  2065. and agree to abide by those terms.
  2066.  
  2067.  
  2068. Name (Print) ______________________________________________________
  2069.  
  2070. Signature _________________________________________________________
  2071.  
  2072. Company ___________________________________________________________
  2073.  
  2074. Address ___________________________________________________________
  2075.  
  2076.         ___________________________________________________________
  2077.  
  2078.         ___________________________________________________________
  2079.  
  2080. City    ____________________________________________________________
  2081.  
  2082. State   ________________          Zip Code ____________________
  2083.  
  2084.  
  2085. Day Time Telephone (include area code) ________________________
  2086.  
  2087.  
  2088. I received my copy of DMLIST from:
  2089.  
  2090. _______________________________________________________________
  2091.  
  2092.  
  2093. Was any fee charged for the copying of this program ?
  2094.  
  2095. ____________________
  2096.  
  2097. Type of computer
  2098.  
  2099. _____________________________________________
  2100.  
  2101.  
  2102. DOS version number
  2103.  
  2104. ____________________
  2105.  
  2106.  
  2107.  
  2108. dml1.000188
  2109.        January 1988                  DMLIST                  PAGE 32
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.                               Future Updates
  2116.  
  2117.  
  2118. There are several additional features planned for future releases of
  2119. DMLIST.  You will see these listed below.  Version 2.0 is now targeted for
  2120. March 1, 1988.  This is not a promise of all of the features below.  In
  2121. fact I do not plan to have all of these in version 2.0.  Remember I am not
  2122. really a software vendor but I do want to help!
  2123.  
  2124. Updates are currently $15.00 PER COPY.  This price is guaranteed through
  2125. March 1, 1988.  But remember there is no guarantee that an update will be
  2126. made on this date.  It is my target.  I am telling you all of this in an
  2127. attempt to honest with you.  I would also like to know when an update is
  2128. planned and what features to expect.  I assume you would too.
  2129.  
  2130. If you feel you have a valid suggestion, please drop me a line.  After all
  2131. this program is for all users, not just me. Unless you want to pay an
  2132. hourly fee, this program will NOT be modified for an obscure language.
  2133. Also, if you feel that any of the features below are mandatory for a
  2134. complete program let me know.
  2135.  
  2136.                         Additional Features Planned
  2137.  
  2138. 1) A default parameter file to ALWAYS be loaded on startup.  Personally I
  2139. do not use eight character tabs.  I find it a nuisance to always type -B5
  2140. or load a response file every time I start the program.  In addition to
  2141. command line parameters it will allow for additional options such as a
  2142. printer startup strings.
  2143.  
  2144. 2) A menu driven program.  This will actually be included for the
  2145. inexperienced user and invoked with a different name so this user has a
  2146. choice.
  2147.  
  2148. 3) C++ support.  I am not sure that this will really be required, but I
  2149. intend to check it out.  But I am not even sure I like the language from
  2150. some of the reviews I have read.
  2151.  
  2152. 4) Keyword capitalization and/or emphasis.  This will be a handy
  2153. documentation feature.  What this means, for example, in a C program every
  2154. time char is encountered it will be changed to CHAR and emphasized in the
  2155. listing.
  2156.  
  2157. 5) Reformatting for C, Pascal and dBase programs.  You will then be allowed
  2158. to save the reformatted file for recompilation.
  2159.  
  2160. 6) Support for alternate comment delimiters in BASIC and Pascal.  BASIC
  2161. allows ' and REM, and Pascal uses {} and (**).  Currently only ' is
  2162. supported for BASIC and {} for Pascal.
  2163.  
  2164. 7) Selective printing of cross reference items.  i.e. - Only numeric
  2165. literals or only numeric literals.
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174. dml1.000188
  2175.        January 1988                  DMLIST                  PAGE 33
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.                                 User Survey
  2182.  
  2183.  
  2184. This is an attempt to provide the users of this program with more support
  2185. in the future and is strictly optional.  Please feel free to attach another
  2186. page if there is not enough room for your explanations.  You do not have to
  2187. register your program to send in this survey.  Please complete it and mail
  2188. to: 
  2189.               D. M. Software And Systems
  2190.               6572 Suson Woods Drive
  2191.               St. Louis, MO  63128
  2192.  
  2193. Program this form is from _____________________________________________
  2194.  
  2195. Version _______________________________________________________________
  2196.  
  2197. What could be done to improve this program? ___________________________
  2198.  
  2199. _______________________________________________________________________
  2200.  
  2201. What could be done to improve the documentation ? _____________________
  2202.  
  2203. _______________________________________________________________________
  2204.  
  2205. What features does this program contain that you like? ________________
  2206.  
  2207. _______________________________________________________________________
  2208.  
  2209. What do you dislike about it? _________________________________________
  2210.  
  2211. _______________________________________________________________________
  2212.  
  2213.  
  2214. What make and model of equipment are you going to run this program on ?
  2215.  
  2216. _______________________________________________________________________
  2217.  
  2218. What CPU is in this machine? (check one)
  2219. 8086/8088 ___  80186 ___  80286 ___ 80386  V20 ___ V30 ___ V40 ___
  2220.  
  2221. Which math co-processor do you have?
  2222. None ___ 8087 ___ 80287 ___ 80387 ___
  2223.  
  2224. If you have a modem, what is its make, model and maximum baud rate?
  2225.  
  2226. _______________________________________________________________________
  2227.  
  2228. What operating system and version are you using?
  2229.  
  2230. _______________________________________________________________________
  2231.  
  2232. If you operate in a networked environment, which one and what version ?
  2233.  
  2234. _______________________________________________________________________
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240. dml1.000188
  2241.        January 1988                  DMLIST                  PAGE 34
  2242.  
  2243.  
  2244.  
  2245.  
  2246.  
  2247.                                 User Survey
  2248.  
  2249.  
  2250. If you did not register this program, why not? ________________________
  2251.  
  2252. _______________________________________________________________________
  2253.  
  2254.  
  2255.  
  2256. What other program(s) would you like to see released as user supported
  2257. software in the future?  Please be specific.  Don't give me just a name, I
  2258. would like a complete description.
  2259.  
  2260. _______________________________________________________________________
  2261.  
  2262. _______________________________________________________________________
  2263.  
  2264. _______________________________________________________________________
  2265.  
  2266. What is your job title? _______________________________________________
  2267.  
  2268. Is this copy going to be used by a company ? __________________________
  2269.  
  2270. If so,
  2271.     How many people are in the Data Processing and IC? ________________
  2272.  
  2273.     How many PC's are there in your company ? _________________________
  2274.  
  2275.     How many of these have modems? ____________________________________
  2276.  
  2277.     How many programmers are employed? ________________________________
  2278.  
  2279.     Do you use contractors? ___________
  2280.  
  2281.     If so, how many and what type of functions do they perform? _______
  2282.  
  2283.     ___________________________________________________________________
  2284.  
  2285.     ___________________________________________________________________
  2286.  
  2287.  
  2288. Which four languages are most frequently used by you or in your IC?  Please
  2289. list the vendor and version.
  2290.  
  2291.     Language    Vendor                                   Version
  2292.  
  2293.     __________  _______________________________________  ________________
  2294.  
  2295.     __________  _______________________________________  ________________
  2296.  
  2297.     __________  _______________________________________  ________________
  2298.  
  2299.     __________  _______________________________________  ________________
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306. dml1.000188
  2307.        January 1988                  DMLIST                  PAGE 35
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.                                 User Survey
  2314.  
  2315.  
  2316. Please check any of the following operating environments you may use, or
  2317. plan to use in the near future.
  2318.  
  2319.     OS/2 ___   Windows Dos ___   TopView ___   Unix ___   Xenix ___
  2320.  
  2321. What program editor do you currently use and what features does it have
  2322. that you consider mandatory?
  2323.  
  2324. _______________________________________________________________________
  2325.  
  2326. _______________________________________________________________________
  2327.  
  2328. _______________________________________________________________________
  2329.  
  2330. Should D. M. Software And Systems start its own bulletin board? Why? If so,
  2331. which one do you find the most useful?  What type is it? (RBBS, FIDONet,
  2332. etc.)  What features should it incorporate?
  2333.  
  2334. _______________________________________________________________________
  2335.  
  2336. _______________________________________________________________________
  2337.  
  2338. _______________________________________________________________________
  2339.  
  2340. Can I contact you about this survey ?  If so please give me your name,
  2341. phone number and the hours you can be reached.
  2342.  
  2343. Name _______________________________  Phone ___________________________
  2344.  
  2345. Hours you can be reached at this phone ________________________________
  2346.  
  2347. Time zone?   Eastern ____  Central ___  Mountain ___ Pacific ___
  2348.  
  2349.  
  2350.  
  2351.  
  2352.  
  2353.  
  2354.  
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.  
  2363.  
  2364.  
  2365.  
  2366.  
  2367.  
  2368.  
  2369.  
  2370.  
  2371.  
  2372. dml1.000188
  2373.        January 1988                  DMLIST                  PAGE 36
  2374.  
  2375.  
  2376.  
  2377.